﻿<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
<head>
	<link rel="Stylesheet" type="text/css" media="screen" href="Screen.css" />
  <title>STP_SetMstConfigTableAndComputeDigest1</title>
</head>
<body>
	<h3>STP_SetMstConfigTableAndComputeDigest1</h3>
	<hr />
<pre>
void STP_SetMstConfigTableAndComputeDigest1
(
    BRIDGE*              bridge,
    const unsigned char  mstids [4094],
    unsigned int         timestamp
);
</pre>
	<h4>
		Summary</h4>
	<p>
		Sets the 
		MST Config Table (VLAN to MSTID mapping) and computes the Digest field of the MST Configuration Identifier.</p>
	<h4>
		Parameters</h4>
	<dl>
		<dt>bridge</dt>
		<dd>Pointer to a BRIDGE object.</dd>
		<dt>mstids</dt>
		<dd>Pointer to an array of 4094 values, where each values specifies the MSTID mapped to a 
			VLAN number.</dd>
		<dt>timestamp</dt>
		<dd>A timestamp used for the debug log. </dd>
	</dl>
	<h4>
		Remarks</h4>
		<p>
			This function may be called only for MSTP bridges (i.e., if <code>STP_VERSION_MSTP</code> was passed 
			to <a href="STP_CreateBridge.html">STP_CreateBridge</a> or
			<a href="STP_SetStpVersion.html">STP_SetStpVersion</a>).</p>
	<p>
		See §13.7 in 802.1Q-2011 for more information about the MST Configuration Identifier.</p>
	<p>
		The bridge supports only the number of trees that was specified in the call to <a href="STP_CreateBridge.html">STP_CreateBridge</a>. The caller must not attempt to map a VLAN to a non-existent tree, i.e., 
		all values in the <code>mstids</code> array must be lower than the <code>treeCount</code> parameter that was specified in the 
		call to STP_CreateBridge. The STP library will raise an assertion if the caller attempts to do that.</p>
	<p>
		The value at index 0 of the <code>mstids</code> array corresponds to VLAN 1, the value at index 1 to 
		VLAN 2, and so on until the value at index 4093, which corresponds to VLAN 4094.</p>
	<p>
		The STP library computes the Digest as described in 13.7.4) in 802.1Q-2011.</p>
	<p>
		If this function is not called, a default mapping is used which is generated by
		<a href="STP_CreateBridge.html">STP_CreateBridge</a>. See the Remarks section there for 
		more information.</p>
	<p>
		This function may not be called from within an <a href="STP_CALLBACKS.html">STP callback</a>.</p>
	
</body>
</html>
